home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PRINTER / RPTP33.ARJ / RPTP.DOC < prev    next >
Text File  |  1992-02-27  |  12KB  |  288 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11. *******************************************************************************
  12. *                                    RPTP                                     *
  13. * Ron's Print To Printer program, RPTP V3.3, Feb. 1992.                       *
  14. * Last update : Feb. 27, 1992.                                                *
  15. *******************************************************************************
  16.  
  17.  
  18.                  PAGE 5 - Date XX/YY/ZZ File FFNNBBVV.EEE
  19.  
  20.                                          ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  21.                                         ▓                 ▓
  22.        ░░░░░░░░░░░                      ▓ ░░░░░░░░░░░░░░  ▓
  23.        ░▒▒▒▒▒▒▒▒▒▒░                     ▓  ▒▒▒▒▒▒░▒▒▒▒▒▒▒ ▓
  24.        ░▒▓▓▓▓▓▓▓▓▓░▒                     ▓       ░▒       ▓ ░░░░░░░░
  25.        ░▒▓        ░▒▓                     ▓▓▓▓▓▓ ░▒ ▓▓▓▓▓▓  ░▒▒▒▒▒▒▒░
  26.         ░░░░░░░░ ░ ▒▓     ░░░░░░░░             ▓ ░▒ ▓       ░▒███████░
  27.        ░ ▒▒▒▒▒▒▒░ ▒ ▓     ░▒▒▒▒▒▒▒░            ▓ ░▒ ▓       ░▒▓      ░▒
  28.        ░▒▓▓▓▓▓▓▓▓░ ▓      ░▒       ░           ▓ ░▒ ▓       ░▒▓     ░ ▒█
  29.        ░▒▓        ░       ░▒       ░▒          ▓ ░▒ ▓       ░░░░░░░░ ▒ █
  30.        ░▒▓        ░▒      ░▒      ░ ▒          ▓ ░▒ ▓ o     ░▒▒▒▒▒▒▒▒ █
  31.         ▒▓         ▒▓     ░░░░░░░░ ▒           ▓  ▒ ▓       ░▒████████
  32.          ▓ on's     ▓     ░▒▒▒▒▒▒▒▒             ▓   ▓       ░▒█
  33.                           ░▒                     ▓▓▓         ▒█ rinter
  34.                           ░▒                                  █
  35.                            ▒ rint
  36.                           ▓ ▓▓▓▓▓▓▓
  37.                            ▓
  38.  
  39.                  PAGE 5 - Date XX/YY/ZZ File FFNNBBVV.EEE
  40.  
  41. File List
  42. ---------
  43.  
  44.  This package contains the following files :
  45.  
  46.  RPTP.EXE       - RPTP program executable.
  47.  RPTP.DOC       - This file.
  48.  RPTP.REG       - Registration File.
  49.  PROGRAMS.TXT   - ISoft D&M shareware products description.
  50.  RPTP.PRT       - Sample Printer Definitions.
  51.  
  52. Why Register
  53. ------------
  54.  
  55.   RPTP is a shareware product, if you find this product valuable, 
  56.  please register it. This section describes the reasones you should register.
  57.  
  58.   By registering you will receive a printed manual, with many examples, a 
  59.  diskette with the latest RPTP version, and the complete source code for RPTP, 
  60.  and - you will help us to create the next version of RPTP - that will include 
  61.  even more features then the features that are currently available!, 
  62.  we might even add YOUR enhancment requests!
  63.  
  64. Whats New
  65. ---------
  66.  
  67.   Version 3.3 added the /? help page parameter. From this version RPTP is
  68.  distributed by ISoft D&M, P.O.B 5517, Coralville IA 52241, U.S.A. 
  69.  
  70.   Version 3.2 added the /TS parameter to support printer termination string.
  71.  
  72.   Version 3.1 added the /SU parameter to specify printer setup string.
  73.  
  74.   Version 3.0 supports printer control codes using the /AP+ parameter, 
  75.  Please refer to the "Printer Usage" section in this document for printer
  76.  control commands. Also added the /PFnnn and /EPc parameters which are
  77.  related to printer formatting support. These switches are described in 
  78.  the "Printer Usage" section in this document, as well.
  79.  
  80.   From Version 2.0 multiple files can be printed in one document using the
  81.  /IC switch, with a command file as input, Please refer to the 
  82.  "Using Command File" section in this document for the command file
  83.  syntax.
  84.  
  85.   Version 1.5 added the /W+, /W- switches. With /W+ lines longer then the 
  86.  columns specified will be wraped around, with /W- they will be truncated.
  87.  
  88.   From version 1.5 the /XF and /XH flags are defaulted to + (TRUE), instead
  89.  of - (FALSE), that was the standard up to that version.
  90.  
  91.   Version 1.4 added the /U+, /U- switches. With /U+ a form feed character
  92.  is sent after the footer, with /U- text lines are sent until the end of page.
  93.  
  94.   Version 1.3 added the /N+, /N- switches, to display line numbers at the left
  95.  of each text line printed.
  96.  
  97.   Version 1.2 Added the -PSsss and -PEeee switches to choose the start and
  98.  end pages to be printed. (This feature is helpfull if you have a paper
  99.  jam during one of the printing sessions, and you do not want to print
  100.  the entire document again).
  101.  
  102. Introduction
  103. ------------
  104.  
  105.   Have you ever tried to print a program listing to a continous paper printer ?
  106.  of course you did, every programmer does. What did you think about these lines
  107.  that disappeared between the pages, didn't you wish you could skip a few
  108.  pages before and after each page break ?, and what about a small header or
  109.  a footer with the program's name and date ?, well.. that would be nice, 
  110.  wouldn't it ?, and what if the program is built of several files, you want
  111.  to print using the same numbering system ?, well .., and what about some
  112.  printer control help, ..
  113.  
  114.   I hoped, for a long time, to have such a small helpful program as RPTP is,
  115.  but, because I could not find one I could use, I had to write RPTP myself.
  116.  
  117. Usage
  118. -----
  119.   At the command line type RPTP and press Enter to receive a help screen, that
  120.  lists the program's command line format, and options.
  121.  
  122.        RPTP V3.3, ISoft D&M, P.O.B 5517, CORALVILLE IA 52241, U.S.A
  123. usage: RPTP [e-options] input-file [e-options] [output-file] [e-options] 
  124. e-options:   @optfile - file of options 
  125.              options  - options displayed below 
  126. options: /Lxxx  /Cyyy   - xxx lines/yyy cols. per page 
  127.          /SH    /SF     - standard header/footer 
  128.          /U+    /U-     - use/do not use form feed character 
  129.          /H-    /H+hhh  - no header/use hhh as header 
  130.          /F-    /F+fff  - no footer/use fff as footer 
  131.          /W+    /W-     - wrap/do not wrap lines 
  132.          /XH+   /XH-    - center/do not center header 
  133.          /XF+   /XF-    - center/do not center footer 
  134.          /PSsss /PEeee  - start at page sss, end at page eee 
  135.          /N+    /N-     - print/do not print line numbers 
  136.          /IF    /IC     - input file/command file 
  137.          /AP+   /AP-    - allow/do not allow printer commands 
  138.          /EPc   /TS     - escape printer code=c/printer termination string sss
  139.          /PFnnn /SUsss  - printer file nnn/printer setup string sss
  140.          /?             - display help
  141.  
  142. Notice - in option files, place each option in a line by itself.
  143.  
  144.  
  145.  
  146.  
  147.  Notice - if the /IC switch is given the input to the RPTP program is   
  148.           taken from a command file, with the file given as input-file
  149.           used as the command file. Please refer to the "Using Command File"
  150.           section. 
  151.  
  152.  By default RPTP assumes a simple input file (/IF switch), and the input-file          
  153.  given is used as the input source to the program.
  154.  
  155. Using Command File 
  156. ------------------
  157.  
  158.    With Version 2.0 RPTP allows the user to merge multiple text files into 
  159.   one printed document. If you specify the /IC switch on the command line
  160.   the input-file given on the command line is considered to be a command
  161.   file that have the following syntax :
  162.  
  163.    Every line serves as one command to be processed by RPTP.  
  164.  
  165.    If the line contains the NEWPAGE command the output report performs a    
  166.    new page break, and starts printing the next file specified on the
  167.    top of the next page.
  168.  
  169.    Any other line command is considered to be a file name to be printed. 
  170.  
  171.  An example :   
  172.  
  173.   When I want to print the RPTP program and documantation for my own use
  174.   I use a command file named RPTP.MLT which has the following structure :
  175.  
  176. RPTP.PAS  
  177. NEWPAGE
  178. BASICREP.PAS
  179. NEWPAGE
  180. RPTP.DOC
  181.  
  182.   using the following command :
  183.  
  184.   C:\> rptp rptp.mlt /ic  
  185.  
  186.   The output from this command is a printed document that contains both the  
  187.  RPTP program, a report unit used to create the program, and this file.
  188.  
  189. Printer Usage
  190. -------------
  191.  
  192.   From Version 3.0 RPTP can perform printer formatting processing using the
  193.  /AP+ parameter switch. by default /AP- is assumed, and no printer command 
  194.  support is available, if /AP+ is given on the command line, or option file, 
  195.  RPTP replaces any printer escape code found with the appropriate printer 
  196.  setup string. The printer escape code is defined by 2 characters in the text 
  197.  source file, The first one is the printer escape character which can be set 
  198.  using the /EPc command, (The default is character ascii 251 which can be 
  199.  entered using the ALT-251 combination from the keypad. The second character 
  200.  in the printer escape code is the printer setup identifier using the 
  201.  following values :
  202.  
  203.    underLineStart    =   'U'
  204.    underLineEnd      =   'u'
  205.    boldStart         =   'B'
  206.    boldEnd           =   'b'
  207.    user1             =   '1'
  208.    user2             =   '2'
  209.    user3             =   '3'
  210.    user4             =   '4'
  211.    user5             =   '5'
  212.    user6             =   '6'
  213.    user7             =   '7'
  214.    user8             =   '8'
  215.    user9             =   '9'
  216.    user0             =   '0'
  217.    resetPrinter      =   '@'
  218.    proportional      =   'P'
  219.    fixedSpacing      =   'p'
  220.    ItalicStart       =   'I'
  221.    italicEnd         =   'i'
  222.    uprightStart      =   'G' { same as italicEnd on HP laserJet IIIp }
  223.    condensedStart     =  'C'
  224.    condensedEnd      =   'c' { same as upright on HP laserJet IIIp }
  225.    expandedStart     =   'E'
  226.    expandedEnd       =   'e' { same as upright on HP laserJet IIIp }
  227.    outLineStart      =   'O'
  228.    inLineStart       =   'N'
  229.    shadowedStart     =   'S'
  230.    outLineShadowed   =   'o'
  231.  
  232.   By default the printer commands are replaced by HP laserJet IIIp setup   
  233.  strings, however, setup strings for different printers can be desinged and
  234.  using the /PFnnn switch on the command line. If you want to create your
  235.  own printer specific configuration file use the supplied RPTP.PRT template
  236.  file and overwrite the printer codes starting from position 20 (col. 20) 
  237.  in the file with the appropriate codes. My own configuration file is
  238.  used only to define that user0 command will set the PC-8 HP font, and that
  239.  user1 will select the Roman8 font. My configuration file has the following
  240.  structure :
  241.    
  242. user1              (8U
  243. user0              (10U
  244.  
  245.   It is important that the printer setup codes  will start in col. 20, and
  246.  will not have any trailing spaces after them!.
  247.  
  248. Warranty
  249. --------
  250.  
  251.   There is no warranty what so ever, The program is supplied as is,
  252.  The distributer (ISoft D&M), or the author (Loewy Ron), are not,
  253.  and will not be responsible for any damages, lost profits, 
  254.  or inconveniences caused by the use, or inability to use this program. 
  255.  The use of the program is at your own risk. 
  256.  By using (or attempting to use) the program you agree to this.
  257.  
  258. General
  259. -------
  260.  
  261.   RPTP is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  262.   
  263.   RPTP is (c) copyrighted by Loewy Ron, 1991, 92.
  264.  
  265.   RPTP is a shareware program, please register your copy. 
  266.   To register your copy of RPTP please refer to the supplied
  267.   RPTP.REG file. 
  268.  
  269.   Other programs distributed by ISoft D&M are described in the supplied  
  270.   PROGRAMS.TXT file.
  271.  
  272. Contact
  273. -------
  274.  
  275.   Please contact :
  276.  
  277.   ISoft D&M,  
  278.   P.O.B 5517
  279.   Coralville IA 52241,
  280.   U.S.A
  281.  
  282. Credits
  283. -------
  284.  
  285.   RPTP was written using Turbo-Pascal V6.0, a copyright of Borland International.
  286.  
  287.   HP and HP laserJet IIIp are trademarks of Hewlett Packard. 
  288.